Skip to main content

Definitions

View and zooming area definitions​

LightningChart views contain several various areas determined by the information they hold. The areas can be seen as two-dimensional rectangles based on the content of the view. These definitions are uniform regardless of the view type. They are used especially in zooming operations to determine which areas of the chart will be shown.

  • ChartArea/ViewArea: The whole area including the chart and the margins.

  • MarginRectangle: MarginRectangle (or MarginRect) includes the area inside the margins.

  • GraphArea: The area defined by the axis ranges. Contains major and minor grids. The data is drawn in this area, unless some data values exceed the axis ranges.

  • Background area / circle: Is mostly the same as the GraphArea. Contains also the parts of the graph outside the axis ranges and the grids.

  • LabelsArea: The area consisting of the graph and the axis labels. Ignores the data.

  • Data: The area containing only the data. Defined by the minimum and the maximum values of the data.

  • DataAndLabelsArea: Data and LabelsArea combined. All data, axes, labels and markers are included.

  • Border: A customizable, one-pixel wide rectangle, which indicates the location of the margins. Its visibility can be changed by disabling/enabling it.

  • Margins: Margins are empty spaces around the graph area. Most of the contents of the view are fitted inside the margins and clipped outside them.

  • ZoomPadding: The space left between the margins and another, pre-defined area after a zooming operation (see chapter 7.19.3). It has no effect in ViewXY.

View3D definitions View3D and zooming area definitions

ViewXY definitions A quick overview of ViewXY

  • Graph margins: Margins are adjusted automatically by default by axis count and their settings. By setting ViewXY.AxisLayout. AutoAdjustMargins = False, Margins property applies, which allows the margin sizes to be set manually. Set all margins to 0 to make the graph fill the whole view area. See subchapter Margins for further information.

  • Graph border: A border is drawn around the graph area, in the location of margins. Border property can be used to change its color and visibility as well as to determine if it should be rendered behind the series. More about border in subchapter Margins.

  • Background: Set the background fill with Background (ChartBackground in WPF) property. There are plenty of filling options available. See Setting background fill.

  • Graph background: Set the graph background fill with GraphBackground property. Graph is the area where all grids, series, series cursors, event markers etc. are rendered. For example,

chart.ViewXY.GraphBackground.Color = Colors.DarkBlue;
  • Title: This is the main title for the chart. Set the text, shadow, color, text border, rotation, font, alignment etc. with Title.Text, Title.Shadow… properties. For example,
chart.Title.Text = "Title text";

  • Y-axes: The vertical axes representing Y values. See Axis class.

  • X-axis: The horizontal axes representing X values. See Axis class.

  • Annotations: Annotations allows displaying mouse-interactive text labels or graphics anywhere in the chart area. See AnnotationXY.

  • Legend box: Lists all the series of the chart. See LegendBoxXY.

  • Scrollbar: A scrollbar having unsigned 64-bit value range, to support massive count of sample indices directly. In fact, HorizontalScrollBars and VerticalScrollBars are collection properties in the chart root level, but they are aware of ViewXY’s margins. See chapter 13.

  • AutoPadding: From version 12.5 ViewXY has AutoPadding property. This is padding for control's edges in PXs. This is outer edge or rim of the chart, which encloses ViewXY Margins. See page AutoPadding for details.

info

Chapter references to be updated soon.